home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_2 / songs24.zip / SONGS.DOC < prev    next >
Text File  |  1992-11-08  |  11KB  |  266 lines
  1.  
  2.                                Name that Tune 2.4
  3.                                    =========
  4.  
  5.          One of The Livewire BBS PCBoard(TM) multi-BBS Doorware programs.
  6.                  Supporting PCBoard, Wildcat!, Gap, QBBS, RBBS,
  7.                         Remote Access, SpitFire and WWIV
  8.  
  9.                                   Written By
  10.  
  11.                                 Richard Paquette
  12.                                    PO Box 416
  13.                               Mt. Laurel, NJ 08054
  14.                                (C) Copyright 1991
  15.                                All Rights Reserved
  16.  
  17.                  DOOR DESCRIPTION!
  18.  
  19.   The "Name that Tune" door is one of it's kind.. it will challenge a user by
  20.   giving them the first "exact" line of a song and let them guess the exact
  21.   name of that song!
  22.  
  23.   The player is only given FIVE questions.. each having three guesses at a
  24.   randomly selected song and the point worth is randomly selected for each
  25.   song.. the value of points is based on: Five time worth on first guess,
  26.   doubled on the second guess and even money on third guess.
  27.  
  28.   After the three questions the user is brought back to the Main Menu where
  29.  they can view current scores or quit to the BBS.. 
  30.  
  31.                                       FILES
  32.  
  33.             The following files are packaged with this ZIP
  34.  
  35.  songs.exe      <--- executable program must be in directory at all times
  36.  songs.cfg      <--- sample configuration file, must have one for each node
  37.  songs          <--- Sample batch file to call up door program
  38.  songs.doc      <--- What you are reading right now
  39.  songdata.dat   <--- Original question/answer file
  40.  History.doc    <--- History of door versions
  41.  order.frm      <--- Order form for all Livewire Doors
  42.  
  43. Example Configuration for Name that Tune
  44.  
  45.         c:\pcb\users.sys         <=- Full name of your systems file (see below)
  46.         The Livewire BBS         <=- Full name of your BBS
  47.         Richard                  <=- Full first name of Sysop
  48.         Paquette                 <=- Full last name of Sysop
  49.         123456                   <=- Your reg number (Something must be here!)
  50.         2                        <=- Number of songs per game play 1-99
  51.  
  52. REGISTERED DOOR INFORMATION
  53.  
  54.  Once this door is registered, you can get "songutil.exe" which will
  55.  allow you to add all the questions and answers you want to the existing
  56.  data files...
  57.  
  58. GENERAL CONFIGURATION EXAMPLES
  59.  
  60.         EXAMPLE CONFIGURATION FILE FOR PCBOARD.SYS
  61.         ------------------------------------------
  62.  
  63.         C:\PCB\PCBOARD.SYS  <=-  (Full pathname of your PCBOARD.SYS file)
  64.         The Livewire BBS    <=-  (Change this to your BBS name)
  65.         Richard             <=-  (The Sysop's first name)
  66.         Paquette            <=-  (The Sysop's last name)
  67.  
  68.         EXAMPLE CONFIGURATION FILE FOR USERS.SYS
  69.         ------------------------------------------
  70.  
  71.         C:\PCB\USERS.SYS    <=-  (Full pathname of your USERS.SYS file)
  72.         The Livewire BBS    <=-  (Change this to your BBS name)
  73.         Richard             <=-  (The Sysop's first name)
  74.         Paquette            <=-  (The Sysop's last name)
  75.  
  76.         EXAMPLE CONFIGURATION FILE FOR DOOR.SYS
  77.         ---------------------------------------
  78.  
  79.         C:\BBS\DOOR.SYS     <=-  (Full pathname of your DOOR.SYS file)
  80.         The Livewire BBS    <=-  (Change this to your BBS name)
  81.         Richard             <=-  (The Sysop's first name)
  82.         Paquette            <=-  (The Sysop's last name)
  83.  
  84.         EXAMPLE CONFIGURATION FILE FOR CALLINFO.BBS
  85.         -------------------------------------------
  86.  
  87.         C:\BBS\CALLINFO.BBS <=-  (Full pathname of your CALLINFO.BBS file)
  88.         The Livewire BBS    <=-  (Change this to your BBS name)
  89.         Richard             <=-  (The Sysop's first name)
  90.         Paquette            <=-  (The Sysop's last name)
  91.  
  92.         EXAMPLE CONFIGURATION FILE FOR DORINFOx.DEF
  93.         -------------------------------------------
  94.  
  95.         C:\BBS\DORINFOx.DEF <=-  (Full pathname of your DORINFOx.DEF file
  96.                                   where 'x' is the BBS Node number.
  97.         The Livewire BBS    <=-  (Change this to your BBS name)
  98.         Richard             <=-  (The Sysop's first name)
  99.         Paquette            <=-  (The Sysop's last name)
  100.  
  101.         EXAMPLE CONFIGURATION FILE FOR SFDOORS.DAT
  102.         ------------------------------------------
  103.  
  104.         C:\BBS\SFDOORS.DAT  <=-  (Full pathname of your SFDOORS.DAT file)
  105.         The Livewire BBS    <=-  (Change this to your BBS name)
  106.         Richard             <=-  (The Sysop's first name)
  107.         Paquette            <=-  (The Sysop's last name)
  108.  
  109.         EXAMPLE CONFIGURATION FILE FOR CHAIN.TXT
  110.         ----------------------------------------
  111.  
  112.         C:\BBS\CHAIN.TXT    <=-  (Full pathname of your CHAIN.TXT file)
  113.         The Livewire BBSS   <=-  (Change this to your BBS name)
  114.         Richard             <=-  (The Sysop's first name)
  115.         Paquette            <=-  (The Sysop's last name)
  116.  
  117.                               ==============
  118.  
  119.                         Name that Tune BATCH FILE
  120.  
  121. This is the batch file whose name is entered in PCBSETUP. It should reside in
  122. your default PCB directory. Leave this as is except for changing the paths.
  123.  
  124.           ECHO OFF
  125.           C:
  126.           CD\SONGS
  127.           SONGS SONGS.CFG  <--- Please read NOTE below
  128.           C:
  129.           CD\PCB
  130.           BOARD
  131.  
  132. IMPORTANT NOTE FOR DIGIBOARD USERS:
  133.  
  134.   Songs now includes support for FOSSIL drivers!!! This means your Doors
  135.  will work with Digiboard (e.g. Wildcat!'s M version) and other multi-port
  136.  boards. To activate the Fossil driver support, just include /FD on the
  137.  command line when running the Door. For example:
  138.  
  139.       SONGS SONGS.CFG /FD
  140.  
  141.  If no Fossil driver is available, Songs will display a message to that
  142.  effect and exit gracefully.
  143.  
  144. IMPORTANT NOTE FOR NON STANDARD IRQ's:
  145.  
  146.                   Supports COM 1 to 4 on the standard IRQ's
  147.                     Com1/Com3 = IRQ4 and Com2/Com4 = IRQ3
  148.  
  149.                You can make use of the IRQ environment variable
  150.  
  151.     If you wish to use a non-standard IRQ, add the IRQ number after the 
  152. configuration filename. For example the program is STORE and you want to use 
  153. Com1 and IRQ5. The command line passed to your door would be:
  154.  
  155.                             STORE STORE.CFG /5 
  156.                                    or
  157.              STORE STORE.CFG /%IRQ% using the environment variable
  158.  
  159.     The /5 tells STORE to use IRQ5 rather than the standard IRQ4 that is
  160. normally used with COM1. No /x parameter is needed for the standard IRQ's.
  161.  
  162.    You can also make use of the PCBoard environment variables such as:
  163.  PCBDRIVE and PCBDIR. Or you can use your own for example, let's say that
  164.  your system runs on D: drive and your system directory is call GAP then
  165.  you could use the variables at the start of your batch file such as:
  166.  
  167.    d:\
  168.    cd\doors\facts
  169.    set pcbdrive=d:
  170.    set pcbdir=\gap
  171.    facts facts.cfg
  172.    d:\
  173.    cd\gap
  174.    gap
  175.  
  176.  Then the first line in your cfg would look like this:
  177.  
  178.                      %PCBDRIVE%%PCBDIR\dorinfo.def
  179.  
  180.                                 DOOR OPERATION
  181.                                 --------------
  182.   
  183.   F3    -   Toggles the printer On/Off.
  184.             Value is passed to PCBoard.
  185.   F4    -   Toggles the Page Bell On/Off.
  186.             Value is passed to PCBoard.
  187.   F5    -   DOS Shell.  Allows SysOp to exit to DOS from inside a DOOR.
  188.   F7    -   Toggles the Caller Alarm On/Off.
  189.             Value is passed to PCBoard.
  190.   F8    -   Returns the caller involuntarily to PCBoard.
  191.             Without letting them know that the sysop called them back!
  192.   F9    -   Toggles the local display On/Off.
  193.             Value is passed to PCBoard.
  194.   F10   -   Activates SysOp CHAT mode within the DOOR.
  195.  
  196.   ESC   -   Deactivates CHAT mode.  DOOR is resumed.
  197.   HOME  -   HELP key for status line options.
  198.   UP    -   Allows the SysOp to temporarily give the caller extra time
  199.             while in the DOOR.  This time is NOT passed to PCBoard.
  200.   DN    -   Allows the SysOp to temporarily subtract time from the
  201.             caller while in the DOOR.  This time is NOT passed to PCBoard.
  202.   ALT-N -   SysOp next on toggle.
  203.             Value is passed to PCBoard.
  204.   ALT-X -   PCBoard will exit after current caller logs off.
  205.             Value is passed to PCBoard.
  206.  
  207.                             WATCHDOG/CTTY/ANSI.SYS
  208.                             ----------------------
  209.  
  210.         CTTY and WATCHDOG are not required and should not be used with
  211.         this program.  Songs contains its own communication routines
  212.         which monitor the COM port.  If carrier is lost, it will return
  213.         to PCBoard where the BBS will log the user off the system.
  214.         ANSI.SYS, or something similar, is required for Songs to
  215.         function properly!
  216.  
  217.                                  DISTRIBUTION
  218.                                  ------------
  219.  
  220.         Songs is COPYRIGHTED by Richard Paquette, with all rights
  221.         reserved. This program is being distributed via the SHAREWARE
  222.         concept and as such, may be copied freely with the following
  223.         restrictions:
  224.  
  225.                 * The program must be supplied in it's original
  226.                   unmodified form, including documentation.
  227.  
  228.                 * Songs may not be distributed as part of any
  229.                   commercial application or service without the
  230.                   express, written consent of the author.
  231.  
  232.                 * Vendors of Shareware/Public Domain software may
  233.                   not distribute this program without the express,
  234.                   written consent of the author.
  235.  
  236.                                  REGISTRATION
  237.                                  ------------
  238.  
  239.         Songs represents many hours of programming and the author
  240.         deserves just compensation for his time, efforts and expertise.
  241.         If you find this program to be of some value and you continue
  242.         to use it on your BBS system, you must return the registration
  243.         form provided along with the registration fee. Registration
  244.         entitles you to free upgrades from The Livewire BBS.
  245.  
  246.            **********           REGISTER ONLINE          ***********
  247.  
  248.         You may also call The Livewire BBS and register online via Visa 
  249.         or Mastercard using our online Credit Card door which will produce
  250.         your registration number on the spot! At the Main Board Prompt just
  251.         type  REGISTER  and presto your registration number is given to you
  252.  
  253.         Special access to the Songs Door Conference will be given within
  254.         48 hours after your door registration is received for new versions
  255.         of Songs, Songs Utility along with larger DATA files which are
  256.         created by other Songs registered systems..
  257.  
  258.         Suggestions and/or comments may be sent to the address below or
  259.         via electronic mail to: 
  260.    
  261.               The Livewire BBS 609-235-5297 Mt.Laurel, NJ 08054
  262.                               Richard Paquette
  263.           RelayNet Node ID: LIVEWIRE or Inlelec Node ID is: LIVEWIRE
  264.     
  265.                             ----------------------
  266.